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CROSS-REFERENCE TO RELATED APPLICATIONS 
[0001] This application claims the benefit under 35 U.S.C. Section 120 of the following co- 
5 pending and commonly- assigned U.S. utility patent application(s), which is/are incorporated by 
reference herein: 

[0002] Utility Application Serial No. 10/008,625, filed December 6, 2001, by Gregory Andrew 
Roy, Osman Hamid Bux, Kevin Glen Robinson, and Roderick Gaetan Munro, entitled "VECTOR 
BASED GEOGRAPHIC DATA", attorneys 5 docket number 30566. 17-US-C2, which application is a 

10 continuation of commonly-assigned patent application serial no. 09/41 1,506, filed October 4, 1999, 
by Gregory Andrew Roy, Osman Hamid Bux, Kevin Glen Robinson, and Roderick Gaetan Munro, 
entitled "VECTOR BASED GEOGRAPHIC DATA", attorneys' docket number 30566. 17-US-C1, 
now U.S. Patent 6,337,693, issued on January 8, 2002, which application is a continuation of 
commonly-assigned patent application serial no. 08/757,706, filed on October 30, 1996, by Gregory 

15 Andrew Roy, Osman Hamid Bux, Kevin Glen Robinson, and Roderick Gaetan Munro, entitled 

"VECTOR BASED GEOGRAPHIC DATA", attorneys' docket number 30566. 17-US-01, now U.S. 
Patent 5,966,135, issued on October 12, 1999. 

BACKGROUND OF THE INVENTION 
2 0 1 . Field of the Invention. 

[0003] This invention relates in general to computer implemented geographic information systems, 
and in particular to a geographic information system using vector-based data. 

2. Description of Related Art. 

2 5 [0004] Computer implemented geographic information systems are known in the art. However, 

these geographic information systems display map pictures that are generated using raster data. 
Raster data represents a map picture with points in a grid. For example, on an X-Y axis, there may 
be a thousand points in the X direction and seven hundred and sixty points in the Y direction. Each 
of these points represents a color. For example, some computer systems enable each point to 

3 0 represent one of eight colors. A map picture is then created by determining a color for each point in 

the grid. 
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[0005] Each map picture is static in that portions of the map picture cannot change independently 
of each other. That is, a portion of a map picture cannot be modified while viewing the map picture. 
When a portion of the map picture is to be modified, the entire map picture is replaced. For 
example, each map picture, such as one representing the United States (US), may contain several 
5 layers of information, such as states, counties, and streets. When a user is viewing a map picture of 
the United States and wishes to view the counties in a particular state, the map picture is replaced 
with another map picture that contains the additional information. Typically, the additional 
information is stored at a server computer and the map picture is displayed at a client computer. 
When the map picture that is displayed is to be modified, the additional information is downloaded 
1 0 from the server computer. Because this additional information is in the form of raster data, it is 
typically time-consuming to download this information. 

[0006] Additionally, some computer systems display schematics generated from vector-based data 
in computer aided design (CAD) files. Vector-based data uses descriptions of elements of the 
schematic to create the schematic. For example, if the schematic contains a line segment, the CAD 
1 5 file describes the line segment with an endpoint and a length. Moreover, these computer systems 

enable users to view data in CAD files from the Internet and Intranets. For instance, when a user at a 
computer system wishes to view a schematic, the computer system downloads all of the data in the 
CAD file for that schematic from a data storage device via the Internet. The CAD file typically 
contains data corresponding to different levels of design of the schematic. In some instances, a user 

2 0 may wish to view only some of the data in the files, for example, the highest level of design of the 

schematic. In this case, although only a portion of data is required to display the schematic requested 
by the user, the computer system has already downloaded all of the data in the CAD file. Because it 
is time-consuming to download all of the data, it is inefficient to do so when only a portion of the 
data is required to satisfy a user's request. 

25 

SUMMARY OF THE INVENTION 
[0007] To overcome the limitations in the prior art described above, and to overcome other 
limitations that will become apparent upon reading and understanding the present specification, the 

3 0 present invention discloses a method, apparatus, and article of manufacture for a computer 
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implemented geographic information system that enables efficiently viewing a map picture that is 
generated from vector-based map data retrieved over the Internet or Intranets. In accordance with the 
present invention, a user can define map pictures with vector-based data. A user can also view map 
pictures defined with vector-based data. In particular, when a user requests to view a map picture, 
5 only the map data required to satisfy the request is downloaded. When a user requests additional 
information, additional map data is downloaded to satisfy the request. Moreover, map pictures are 
comprised of objects, such as states and cities. When the object includes a link to additional map 
data, a user can obtain additional information, for example, map data for a different map picture. In 
this case, additional information may be downloaded. Additionally, in accordance with the present 
10 invention, a user can zoom in on an area of the map picture to either view the area with greater 
resolution or obtain additional information about the area. 
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BRIEF DESCRIPTION OF THE DRAWINGS 
[0008] Referring now to the drawings in which like reference numbers represent corresponding 
parts throughout: 

[0009] FIG. 1 is a block diagram of an exemplary hardware environment of the preferred 
5 embodiment of the present invention; 

[0010] FIG. 2 is a diagram illustrating an image that could be displayed on the monitor using 
vector-based geographical data; 

[0011] FIG. 3 illustrates the structure of a map window file. 
[0012] FIG. 4 is a flow diagram illustrating the general logic of the map author; 
1 0 [0013] FIG. 5 is a flow diagram illustrating the general logic of the map viewer after an initial map 
picture is displayed; 

[0014] FIG. 6 is a flow diagram illustrating the logic of the map viewer's response to specific 
requests from the user. 

15 DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 

[0015] In the following description of the preferred embodiment, reference is made to the 
accompanying drawings which form a part hereof, and which is shown by way of illustration a 
specific embodiment in which the invention may be practiced. It is to be understood that other 
embodiments may be utilized as structural changes may be made without departing from the scope of 

2 0 the present invention. 

Overview 

[0016] The present invention comprises a vector-based geographic information system that enables 
creating map window files containing map definition information that defines a map picture, storing 

2 5 and transmitting map data, and viewing map pictures generated using the map data. In particular, the 

present invention includes one or more computer programs that include a map viewer for viewing 
map pictures, a map author for defining map pictures, and a map server for storing and transmitting 
map data over the Internet or over Intranets. 

[0017] A user (i.e., author) uses the map author to create map window files that contain map 

3 0 definition information. The map definition information identifies map layers. Each map layer 
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identifies a grouping of map objects, which are graphical entities. In particular, a map picture can 
have several map layers, each map layer providing additional information for the map picture. A 
map layer can either be static or dynamic. For a static map layer, map data is embedded in the map 
window file as a computer graphic metafile (CGM), and for a dynamic map layer, the location of the 
5 map data is identified in the map window file. For dynamic map layers, the map data for a map layer 
is stored in a spatial data format (SDF) file at one or more map servers. The map window file either 
includes a static map layer or a dynamic map layer that is used to generate an initial map picture. 
The initial map picture is displayed when a user requests to view the map picture. 
[0018] The map window file is stored on a Web server, and the map data that is identified by the 

1 0 map definition information is stored on one or more map servers. The map viewer is used by a user 
to view map pictures. In particular, when a user inputs a request to view a map picture, the map 
viewer downloads a map window file from a Web server. Then, the map viewer reads the map 
definition information in the map window file to identify the map layer identifying the map data 
needed to generate an initial map picture. When the map definition information identifies the 

1 5 location of map data, the map viewer downloads this map data from the specified map server to 
generate the map picture. The map viewer then displays the initial map picture on a computer 
display device. As the user makes requests for additional information for the map picture, the map 
viewer downloads additional map data identified in the map window file from a map server. 
[0019] Until now, geographic information system use on the Internet has been limited to simple 

2 0 applications utilizing map pictures generated from raster data. The present invention provides a net- 
based, client/server framework for real-time access to dynamic map pictures and associated map data 
through a Web browser interface suitable for a wide range of users, from geographic information 
system professionals to casual computer users. In particular, the present invention enables corporate 
customers and developers who use the Internet and business Intranets to display and interact with 

2 5 vector-based map data for applications that include tracking customers, allocating resources, and 

managing facilities or infrastructure. 

[0020] The map data used to generate a map picture may be a combination of map objects and 
graphic objects. The map objects can have uniform resource locator (URL) links. When a map 
object having a URL link is chosen, the present invention jumps directly to data identified by the 

3 0 URL link, such as other map pictures, documents, images, and Web sites. An individual map object 
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is chosen by pointing at the map object with a mouse pointer and double clicking the mouse button. 
The present invention also enables choosing multiple map objects through various techniques, such 
as choosing multiple objects from lists or using a spatial technique of enclosing multiple objects 
within a circle or polygon. Information related to the chosen map objects can be presented in reports. 
5 [0021] Furthermore, users can navigate through the map picture to view different areas of the map, 
for example, by zooming in on areas of interest. When zooming in on an area requires obtaining 
additional map data, the map viewer reads the map window file to obtain the location of the 
additional map data. The map viewer downloads this additional map data and generates a new map 
picture with the additional data. Then, the map viewer displays this new map picture. 

10 

Hardware Environment 

[0022] FIG. 1 is a block diagram that illustrates an example of a hardware environment for the 
preferred embodiment of the present invention, and more particularly, illustrates a typical distributed 
computer system using the Internet and Intranets 100 to connect client computers 110 executing, for 

1 5 example, a computer program embodying the present invention that enables users at the client 

computers 1 10 to view map pictures, to map server computers 140 executing a computer program 
embodying the present invention that transmits vector-based map data to the client computers 110. 
A typical combination of resources may include client computers 110 that are personal computers or 
work stations connected via the Internet 100 to server computers 130, 140 that are personal 

2 0 computers, workstations, mini computers, or mainframes. 

[0023] Generally, the client computers 1 12 are comprised of one or more CPUs 112, various 
amounts of RAM storing computer programs 113, such as a Netscape Navigator 1 14, a map viewer 
1 18 for viewing map pictures, a Web browser 1 16 for accessing information over the Internet, and a 
map author 120, and other data and components typically found in computers. Generally, the server 

2 5 computers 130, 140 are comprised of one or more CPUs, various amounts of RAM storing computer 

programs, such as a Web server 130 for accessing information over the Internet and/or Intranets 100, 
a map server 140 for storing and transmitting vector-based map data, and a common gateway 
interface (CGI) program 150, and other data, such as map data in a spatial data format (SDF) 
structure 160 and map data in a relational database management system (RDBMS) 162, and other 

3 0 components typically found in computers. In addition, the client computers 110 and the server 
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computers 130, 140 may include one or more monitors, and fixed or removable data storage devices 
126, 160, 162 such as hard disk drives, floppy disk drives, and/or CD-ROM drives. Also included 
may be input devices such as mouse pointing devices and keyboards. 

[0024] Both the client computers 110 and the server computers 130, 140 operate under the control 
5 of an operating system, such as Windows, Macintosh, UNIX, etc. Furthermore, both the client 
computers 110 and server computers 130, 140 each execute one or more computer programs 113 
under the control of their respective operating systems. The client computers 110 and the server 
computers 130, 140 interact via the Internet 100. 

[0025] Generally, the computer programs implementing the present invention are tangibly 
1 0 embodied in a computer-readable medium, e.g., one or more of the fixed and/or removable data 

storage devices 126, 160, 162 attached to the computers. For example, at the client computers, under 
control of the operating system, the computer programs 113 may be loaded from the data storage 
devices 126 into the RAM of a computer for subsequent execution by the CPU 112. The computer 
programs comprise instructions which, when run and executed by the computer, causes the computer 
15 to perform the steps necessary to execute the steps or elements of the present invention. Those 

skilled in the art will recognize that the exemplary environment illustrated in FIG. 1 is not intended 
to limit the present invention. Indeed, those skilled in the art will recognize that other alternative 
hardware environments may be used without departing from the scope of the present invention. 
[0026] The map server 140 works in conjunction with the map author 120 and the map viewer 118. 
2 0 The map author 120 is used to create, modify, and electronically publish map window files (.mwf 
files) 122 that define map pictures. After a user creates map window files using the map author 120, 
the user uses the map author 120 to save the map window files 122, for example, at the Web server 
130. 

[0027] The map viewer 118 enables a user at a client computer to view map pictures and their 

2 5 associated data. The map viewer 1 1 8 is currently embodied as a Netscape Navigator browser 114 

plug-in. The Netscape Navigator browser 1 14 interfaces with the Internet and Intranets through the 
Web browser 116. When a user attempts to open a map window file, the Netscape Navigator 
browser 114 automatically invokes the map viewer 118. The map viewer downloads a map window 
file from the Web server 130 and stores the map window file in a data storage device 126. The map 

3 0 window file contains map definition information that identifies map data and the map servers from 
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which the map viewer is to obtain the map data to render and display the map picture. The map 
viewer 118 makes requests for map data from map servers 140 via a Web server 130 and a Web 
browser 1 16 using the communications infrastructure of the Internet and/or one or more Intranets 
100. 

5 [0028] When the map viewer 1 1 8 requests map data from the map server 140, the map server 
retrieves the map data from either the SDF file storage 160 or from the relational database 162 
through an open database connectivity (ODBC) connection 170. The map server returns the 
requested map data to the map viewer 118. 

10 Vector-Based Data 

[0029] FIG. 2 is a diagram illustrating an image that could be displayed on the monitor using 
vector-based geographical data. Objects 202, 204, and 206 are shown in two-dimensional space, 
represented by the X-Y plane 210. Those skilled in the art will recognize that the X-Y plane is 
shown in FIG. 2 for illustration only, and generally is not displayed on the monitor with the object. 

15 The objects 202, 204, and 206 are represented by one or more primitive or coded entries stored in a 
buffer. For example, object 204 is identified as a line with end coordinates (XI, Yl) and (X2, Y2) 
for the line. Object 206 is defined by a point and a radius. Other objects are comprised of other 
primitives, such as triangles, circles, arcs, or other objects. 

[0030] Map definition information defining map pictures using vector-based data is saved in map 
2 0 window files 122 on the Web server 130. The map viewer 118 uses the map window file 122 to 
identify the location of map data on map servers 140 for use in generating the map pictures. This 
map data is communicated from the map server 140 to the map viewer 118 using the services of a 
Web server 130 and Web browser 116. Following installation of the present invention, the Netscape 
Navigator browser 114 recognizes the map window file 122 as a file that requires the Netscape 

2 5 Navigator browser 1 14 to automatically load the map viewer plug-in 1 18 to read the file. The map 

118 viewer downloads the map window file 122 to the data storage device 126. 
[0031] FIG. 3 illustrates the structure of the map window file. In FIG. 3, the map window file 122 
is stored on the data storage device 126. The map window file is a self-contained, portable map 
definition. The map window file describes the map picture and contains the information required to 

3 0 generate and display the map picture. In particular, the map window file contains map definition 
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information including a map window information stream 3 10, a map layer storage 320, a reports 
storage 350, a zoom goto storage 360, and a pop-up menu stream 370. 

[0032] The map window information stream 310 contains information that describes the map 
window, such as the map window name, color attributes, and line styles. The Map Window 
5 Information Stream Table in Appendix A provides a list of the information provided by the map 
window information stream 310. 

[0033] The map window file 122 can contain one or more map layer storages 320. Each map layer 
storage 320 contains information about a map layer, including a map layer information stream 322, a 
map layer attribute set storage 324, an optional map layer CGM stream 332, a map object definition 

10 stream 334, and a map symbol storage 336. The map layer information stream 322 describes the 
map layer by specifying information such as whether the map layer is static or dynamic. The map 
layer is static when the map data for the map layer is contained in the map window file 122, and the 
map layer is dynamic when a location identifier identifying the location of the map layer is contained 
in the map window file 122. 

15 [0034] Additionally, the map layer storage 320 can contain one or more map layer attribute set 

storages 324. The map layer attribute set storage 324 contains the attributes used to display the map 
objects making up the map layer at a particular scale. In particular, the map layer attribute set 
storage 324 contains a map layer attribute set information stream 326, one or more layer attribute 
streams 328, and one or more label attribute streams 330. The map layer attribute set information 

2 0 stream 326 contains information that describes the attributes contained in the map layer attribute set 
storage 324. The map layer attribute streams 328 contain information about particular attributes for 
each type of map object (e.g., marker, text, polyline, or polygon). The map label attribute streams 
330 contains label attribute information for the following map objects: marker, polyline, or polygon. 
[0035] The map layer CGM stream 332 of the map layer storage 320 contains a computer graphic 

2 5 metafile for the map layer. All static map layers are saved as computer graphic metafiles embedded 

within the map window file 122. The map object definition stream 334 of the map layer storage 320 
contains the definition of the map object upon which the map layer is based. The map symbol 
storage 336 of the map layer storage 320 contains one or more symbol definition streams that contain 
the definitions of symbols used in the map picture. The Map Layer Storage Table in Appendix B 

3 0 provides a detailed list of the information contained in the map layer storage 320. 
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[0036] The reports storage 350 contains one or more report definition streams that contain the 
definitions of reports that can be generated using computer programs that can be purchased and 
stored at the Web server 130. The Report Definition Stream Table in Appendix C provides a detailed 
list of the information contained in the report definition stream. The zoom goto storage 360 provides 
5 the categories of areas to which a user can zoom using the zoom goto command. In particular, the 
zoom goto storage 360 contains one or more zoom goto address definition streams 362 that contain 
the definition of an address to which a user can zoom and one or more zoom goto location definition 
streams 364 that contain the location to which a user can zoom. The Zoom Goto Storage Table in 
Appendix D provides a detailed list of the information contained in the zoom goto storage 360. The 
1 0 popup menu stream 370 contains the definition of a popup menu that can be displayed over the map 
picture. The Popup Menu Stream Table provides in Appendix E provides a detailed list of the 
information contained in the popup menu stream 370. 

[0037] Updates to the map server can be updated with the distribution of one map window file. 
The map window file can be saved locally, or distributed to other hosts or users to be copied, 
1 5 modified, re-used and/or embedded within other web pages. The map window files identify map 
layer files. These map layer files are stand-alone map layer definitions that are portable and 
exportable. Moreover, map layer files enable users to build and maintain libraries of map layers that 
can be used internally to build map pictures quickly, or provided to business partners, vendors, or 
clients for use in authoring efforts. 

20 

The Map Author 

[0038] The map author 120 is used to define, modify, and electronically publish map pictures. In 
particular, the map author 120 enables a user to create a map window file containing map definition 
information that identifies map data and the map servers from which this map data can be obtained 
2 5 by the map viewer. FIG. 4 is a flow diagram that illustrates the general logic of the map author 120. 
Block 400 represents the receipt by the map author 120 of a request from a user of a computer to 
create or modify a map picture. Upon receipt of the user's request, the map author 120 enables a 
user to define a map picture having map objects, multiple layers, and other features, which are 
discussed below. 
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[0039] The map author 120 allows for remote authoring. The map author 120 enables authoring 
map pictures over the Internet or over Intranets 100 for publishing from a map server 140 at a 
different location. For example, a business user who wants to use a geographic information system 
for the business on a daily basis, but who does not want to enter into the significant costs associated 
5 with maintaining an in-house geographic information system database, can have a vendor maintain 
the geographic information system. However, the user could use the map author 120 to retain full 
control over published map pictures, even though they are served from a remote map server 140 over 
the Internet or Intranets 100. 

[0040] In particular, Block 402 illustrates that a map window file is created that defines a map 
10 picture. When creating or modifying a map window file, the map author 120 enables the setting of 
map display properties as well as the setting of the level of interaction within a map, allowing the 
user of the map author 120 to see the map pictures as an end-user will, as they are being created. 
Additionally, with an interactive legend, the map layers defined in the map are available with control 
over data source definitions, thematic mapping settings, symbol, line style, and polygon flood/fill 
1 5 settings, as well as visibility by scale control and dynamic/static layer definition. 

[0041] The map author 120 also enables editing of published map properties, including extents, 
colors, menus (e.g., pop-up menus), zoom navigation capabilities, map picture width and scale, and 
map layer properties (e.g., visibility by scale and rendering attributes). 

[0042] Moreover, the map author 120 includes the following features: a view distance feature that 
2 0 enables setting the distance between any two points on the map picture, enabling multiple map 
objects to be chosen by map object list or spatial techniques (e.g., radius or polygon), map 
bookmarking, intelligent map caching, multiple attributes by scale per layer, multiple document 
interface (MDI) and multiple map editing, customized reports associated with map objects, TrueType 
font support, constant sized text, user defined symbols, constant sized symbols, and automatic 
2 5 labeling of features with over-posting resolution. 

[0043] The map author 120 also has an attributes by scale feature that allows the setting of multiple 
attributes for a specific layer based on the layer scale. By using the attributes by scale feature, the 
map author 120 provides a richer looking map picture that appears to change as the end-user zooms 
in to view greater levels of detail and that avoids redundant data retrieval from the server. The map 
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author 120 allows control over map object labeling, including multiple settings to resolve over- 
posting problems at run-time. 

[0044] The map author 120 enables a user to define a map picture using map objects with attached 
URL links. The map author's 120 distributed mapping enables viewing map pictures that are being 
5 drawn and refreshed from more than one map data source. For example, the map author 120 allows 
a user to create map pictures that have property boundaries from a municipal database over-laid on 
top of contours and elevations being served from a government agency database. 
[0045] The map author 120 enables a user to define a map layer by specifying the objects for that 
map layer and indicating that attributes, such as the color of the objects, are to be obtained from a 

1 0 specified database. When the map viewer reads this information in the map window file, the map 
viewer 118 obtains the attribute data via the map server 140. In particular, the map server 140 
handles many types of attribute data by connecting directly to the attribute data in its native format 
when linking to any open database connectivity (ODBC) database which has an ODBC driver. 
Therefore, the user does not need to convert the attribute data in these databases to any particular 

1 5 format. 

[0046] Block 404 illustrates that the map author 120 stores the map window file, for example on 
the Web server 130. The map author 120 can connect to multiple Web servers 130. Therefore, the 
map author 120 enables a user to store the map window file on one or more Web servers 130. 
[0047] Additionally, while defining a map picture, the user is able to access multiple map servers 

2 0 140 for map data. The map author 120 allows a user to specify data that is in various formats. Then, 
when the map viewer 118 reads the map window file defining the map picture, the map viewer 118 
requests the map data from the map server 140. The map server 140 retrieves the specified data for 
the map viewer 118, and a spatial data converter converts data formats for Geographic Information 
System data or Desktop Mapping data into spatial data format. Currently supported file formats 

2 5 include ASCII, Atlas BNA, AutoDesk DXF, ESRI Arc View Shapefiles, and Maplnfo Interchange 
(map information data format (MID) or map information interchange format (MIF)) files. 
[0048] Map window files created using the map author 120 are made available to Internet and/or 
Intranet 100 users by saving and publishing them using the File Save command in the map author 
120. When a map is published, it is saved to a map window file (with the file extension .mwf) 
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within the Web server directory hierarchy. The map window file has a URL so that it can be 
accessed by Internet and/or Intranet 100 users with the map viewer 118. 

[0049] Individuals using a map viewer 1 1 8 can access published map pictures by accessing the 
Web site where the map window file defining the map picture is stored. The URLs for map pictures 
on a Web site can be made available from a HTML (Hypertext Markup Language) Home Page. A 
map picture can also be embedded within a Web page. When the URL for a map picture is placed 
into a Web browser 116, the map picture is displayed in the Web browser's 1 16 user interface. 
[0050] Map window files can be password protected so that particular users can open and modify 
them. Additionally, map window files can be made available to particular users for viewing. 
[0051] Although the map author 120 is typically used in conjunction with the map server 140, in 
one embodiment of the present invention, the map author 120 can be used independently to create 
map window files that contain static map layers (i.e., map layers which can be viewed without 
accessing the map server). The map server 140 is used to add user-defined data to map pictures and 
to publish map pictures on the Web. 

Including Links To Map Pictures 
[0052] Using the map author 120, a user create map window files that identify map objects which 
have links to other information, including map pictures from web pages. When linking to a map 
picture from a web page, a user determines whether the map picture is displayed on the entire 
computer screen or within a window of a browser. A user can also create map window files that 
identify map objects which have links to map pictures embedded in HTML documents, and these 
map pictures can be displayed. 

[0053] Creating a link to a map picture from a HTML document is no different then creating a link 
to any other web document. It is dependent on the HTML anchor (<A>) tag. The following steps 
indicate how the HTML anchor is created: 

1. Begin the anchor with: <A. 

2. Specify the name of the map to link to with the parameter 
HREF- 'mapname.mwf ' . 

3. Enter to name of the map/link to display in the document. 

4. End the anchor tag with: </A> 
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For example: <A HREF= M http://www.mapguide.com/map 

pictures/usa.mwf'>UnitedStatesMap</A>. 
[0054] This entry makes the words "United States Map" link to a map called usa.mwf. When a 
user selects this text through a browser, the map viewer 1 1 8 plug-in will display the US map in the 
current window. 

[0055] Additionally, a user can specify that the map picture be displayed in a different window. 
This is done by adding a Target parameter inside the anchor tag. For example: <A 
HREF='Mp://ww.mapguide.com/mappicto^ 

ap</A>. This entry would display the map picture in a browser window called MAP AREA. If the 
window was not already opened, a new window would be opened. The target parameter can also 
reference the name of a frame instead of a window. 

[0056] A user can specify that a map be displayed already zoomed in to a portion of the map 
picture in the following manner: 

1 . Zoom in on the area using the map viewer 119. 

2. Select the Copy as Bookmark command from the Copy menu to copy the map 
URL to the clipboard. This URL will include the name of the map and URL parameters that 
tell the map viewer 1 19 to zoom to that area. 

3. Paste this URL into the HREF parameter of the anchor tag. 
For example: <A HREF =tt http://www.mapguide.com/map 
pictures/usa.mwf#Lat=37.8 1 &Lon=- 

122.37&Width=20.0&Units=Mi n >UnitedStatesMap</A>. This entry would display a map of 
the San Francisco area. 

[0057] Moreover a map picture can be embedded in an HTML document using the following steps: 

1 . Begin the embed tag with: <EMBED>. 

2. Specify the name of the map to link to with the parameter SRC- f mapname.mwf \ 

3. Specify the width and height of the map in pixels with the WIDTH=NNN and 
HEIGHT=NNN parameters. 

4. End the embed tag with: > 
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[0058] For example: <EMBED SRC= M http://www.mapguide.com/map 

pictures/usa.mwf , WIDTH=300HEIGHT-200>. This entry displays a map of the US in the current 
document. The map picture is 300 x 200 pixels in size. 

[0059] When the map viewer 1 18 displays a map picture by using a Uniform Resource Locator 
5 (URL) link, a number of parameters can be added to the URL link to change the way the map picture 
looks and customize the behavior of the map viewer 118. The format of a Map Window URL and 
optional parameters are displayed in the URL Tables in attached Appendix F. Default values for the 
parameters are shown in bold in the URL Tables. 

[0060] Additionally, when a user moves a mouse over the map picture, if the cursor is pointing to a 
1 0 map object with an associated URL, the cursor appears in the shape of a hand. If the user chooses 
the map object by double clicking on the map object, the map viewer 118 follows the link provided 
by the uniform resource locator and displays the linked information. 

The Map Server 

15 [0061] The map server 140 works in conjunction with the map author 120 and the map viewer 118. 
In particular, when a user creates map window files that define map pictures using the map author 
120, the map author 120 forwards the map window files to the Web server for storage. Then, when a 
user using a map viewer 118 wishes to view map pictures, the map viewer 118 reads the map 
window file to determine from which map servers 140 to obtain vector-based map data and generates 

2 0 map pictures. 

[0062] The map server 140 is a scaleable, fault tolerant, 32-bit, multi-threaded software application 
that serves map data in response to requests from the map viewer 118. The map server 140 is 
scaleable, allowing hardware to be up-scaled for increased performance or to support additional 
users. Moreover, the map server 140 uses remote procedure calls (RPCs) to support multiple map 
25 servers 140 and utilizes the CGI program 150 to interface with web servers 130, including the 
Netscape API interface to integrate with Netscape's Communications or Commerce server. This 
allows the service to be scaled up with computing power to support large numbers of on-line users. 
[0063] The map server 140 is designed to be fault tolerant and includes features such as a self re- 
start mechanism support 24 hours of operation for the server. Additionally, in order to provide full 

3 0 administrative auditing of the site, performance, and history, the map server 140 generates multiple 
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log files which can be used for auditing of usage, processing of statistics, and daily monitoring of 
system functions. 

[0064] The map server 140 supports simultaneous connections to multiple geographic files and 
multiple databases, including relational databases resident locally or residing under UNIX operating 
5 systems on workstations accessible on the network. The map server 140 is easily integrated with 
other processes to retrieve map-based information and supports on-line additions to published map 
content. It integrates easily with existing Web sites and is easy to configure and manage. 
[0065] The map server 140 software consists of three components. The Map Agent component 
receives requests for map data, and queues these requests as they are received. The MapAgent 

10 component then distributes the queued requests to the map servers 140 that are installed and running. 
This allows for scaleable performance and multi-processing. The Administrator component provides 
control for configuring resource security, log file generation, data source directories and database 
access, integration with the Web server 130, and service start or stop. The Service component 
processes the requests for map data. Therefore, in a hybrid network environment, users can realize 

15 the advantages of the Internet and/or Intranets 100 and still maintain data security. The number of 
users or hits on a server is determined by the Hypertext Transport Protocol (HTTP) Web server. The 
map server 140 can disseminate map-based information to multiple users. 
[0066] If a user has map data (data necessary for constructing map pictures), the map data is 
converted into map SDF files and submitted to the map server 140 for storage or transmission. Map 

2 0 data in any of the leading Geographic Information System or Desktop Mapping formats can be 
converted into map SDF files using conversion utilities. Attribute data, which provides more 
information about items on the map, can be stored in a separate database. The attribute data is linked 
to the map data when a user uses the map author 120 to create map window files that define map 
pictures. 

2 5 [0067] The map server 140 is used to disseminate map data to Internet and Intranet 100 users. 

Users can define map pictures using a variety of data and can choose how often to update portions of 
the data by creating map window files. 
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The Map Viewer 

[0068] The map viewer 118 enables a user at a client computer to view map pictures and their 
associated data. The map viewer 1 18 provides data about a subject in a geographic format. For 
example, when a user looks at information through map pictures the user can see patterns and trends 
5 that are not apparent when looking at information through text. In particular, when the user reviews 
real estate listings using the map viewer 1 1 8, the user can see the price of a home relative to the 
prices of other homes in the neighborhood. The user can also see where the home is relative to 
schools and parks. Depending on the information contained for the map picture, the user may also 
be able to view different map layers, such as map layers containing municipal zoning information or 

1 0 demographic information. 

[0069] FIG. 5 is a flow diagram that illustrates the general logic of the map viewer 118. The map 
viewer 1 1 8 is currently embodied as a Netscape Navigator browser plug-in. When a user attempts to 
open a map window file, the Netscape Navigator browser automatically invokes the map viewer 118 
to render and display the vector-based map data contained in the map window file. The map viewer 

15 118 makes requests for map data from map servers 140 using the communications infrastructure of 
the Internet and/or one or more Intranets 100 for display or printing. In particular, when the map 
viewer is invoked, the map viewer downloads the map window file 122. The map viewer then reads 
the map window file to identify the map data for the initial map picture. Next, the map viewer 
generates and displays the initial map picture. 

2 0 [0070] Block 500 represents the map viewer 118 receiving a request to display the map picture 

with additional information. Block 502 represents the map viewer 118 retrieving vector-based 
geographical data from the map server 140 specified in the map window file 122. In particular, the 
map viewer 118 can access published map pictures, which are saved in map window files on the 
Web server 130. While reading a map window file, the map viewer 118 requests map data from the 
25 map server 140 using the services of a Web server 130 and Web browser 116. 

[0071] Block 504 represents the map viewer 118 generating a map picture with the retrieved 
vector-based data. The map viewer 118 uses the information in the map window file to display the 
map picture and to configure the map viewer 118 (i.e., the user interface provided by the map viewer 
118). Block 506 represents the map viewer 118 displaying the generated map picture. Once a map 

3 0 viewer 118 has loaded a map window file, the map viewer 1 1 8 is able to display the map picture and 
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respond to the user's various requests, for example requests to execute a zoom command or choose a 
map object to view additional information. Based on the actions of the end-user, the map viewer 118 
makes requests to a map server 140 for additional map data or other information as required. This 
lowers the processing burden on the map server 140, increasing performance and leveraging the 
5 power of the client computer running the map viewer 118. 

[0072] Moreover, the map viewer 118 provides an interactive legend for layer control. The map 
viewer 1 1 8 enables a user to zoom to a particular width and scale of the map picture. A viewer can 
also zoom in on portions of the map picture. The map viewer 118 also enables a user to view the 
distance between two points on the map picture and perform editing functions, such as copying 
1 0 portions of the map to a clipboard. Moreover, the map viewer 1 1 8 supports map bookmarking and 
connections to multiple servers. 

[0073] The map viewer 118 maintains multi-layer map object and graphic object information in 
structured files in memory and manages the user interface. The map window file, and all other 
information transferred between the map server 140 and the map viewer 1 18, is compressed and 

1 5 encrypted to enhance performance and maintain security. In addition, the map viewer 1 1 8 caches 
map data to eliminate redundant data transfer between the map viewer 118 and the map server 140. 
[0074] While the installation of some Geographic Information Systems or Desktop Mapping 
systems require the installation of over 1000 files, which occupies a large amount of disk space, the 
map viewer 118 typically requires the installation of one file (the map viewer 118 "dll" file), making 

2 0 support, problem solving, and program updates fast, simple, inexpensive, and easy to perform from 
remote sites. 

[0075] FIG. 6 is a flow diagram illustrating the logic of the map viewer's 118 response to requests 
from the user. Block 602 represents the map viewer 1 1 8 waiting to receive an event indicating a 
request from the user. Block 604 is a decision block that represents the map viewer 118 determining 
2 5 whether the event indicates that a map object is pointed to. Block 606 represents that when a map 
object is pointed to, the map viewer 118 displays information about that map object. 
[0076] As a user moves a mouse cursor over map objects in the map picture, information about the 
map object, such as the name of the map object, is displayed in a yellow MapTip window. The name 
of each map object and the layer that it is on are also displayed in the status bar on map pictures that 
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have the status bar displayed. The map object name might be the State on the layer of US States or it 
might be the Zip Code on the layer showing zip codes. 

[0077] Block 608 is a decision block representing that the map viewer 1 1 8 is determining whether 
the event indicates that a map object has been chosen. Individual map objects are chosen by pointing 
5 at the map object using a mouse and double clicking the mouse button. When new map objects are 
chosen, any map objects that were previously chosen will no longer be chosen. A map object can be 
added to the group of previously chosen map objects by holding the <SHEFT> key while choosing 
the map object. 

[0078] The map viewer 118 provides several methods for choosing multiple map objects. This is 
1 0 useful to display further information about the chosen map objects using the view reports command 
from the menu bar. The map viewer 1 1 8 displays the number and type of chosen map objects in the 
status bar at the bottom of the map. 

[0079] In particular, a group of map objects can be chosen by spatial techniques, such as enclosing 
the map objects in a rectangle or a circle or a polygon. Moreover, map objects can be chosen by 

1 5 name using a command from the menu bar. Invoking this command provides a dialog box that 

identifies the map layers and the names of the map objects in each layer. The clear command on the 
menu bar enables a user to remove a map object from the group of chosen map objects. 
[0080] Block 610 represents that the map viewer 118 generates a new map picture with additional 
map data once when a map object has been chosen. Moreover, Block 612 represents the map viewer 

2 0 119 displaying the new map picture. 

[0081] Block 614 is a decision block representing that the map viewer 1 18 is determining whether 
the event indicates the zoom command. The map viewer 118 provides several navigation methods, 
including opening map pictures, panning, and zooming portions of a map picture. 
[0082] Zooming allows a user to easily change the map to either view an area with greater 

2 5 resolution or obtain additional information about the area . Moreover, when a user wishes to view an 

area with greater resolution, because the map picture is generated with vector-based data that has 
already been downloaded, the present invention is able to immediately generate a new map picture 
with the resolution requested using the vector-based data. In the prior art systems which use raster 
data to generate map pictures, when a user wishes to view an area with greater resolution, the prior 

3 0 art systems download raster data for a new map picture having the requested resolution. 
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[0083] Several types of zoom commands are available. A user can choose to zoom in by a factor 
of two by choosing the zoom command from the menu bar, by using the mouse cursor to choose a 
point around which to zoom, and then clicking the mouse button. A user can zoom in to a 
rectangular area by choosing the zoom command from the menu bar and by using the mouse cursor 
5 to select a rectangular area on the map picture. A user can also zoom to a particular width by 

choosing the zoom width command from the menu bar and entering a width (in miles or kilometers) 
that will represent the width of the area displayed in the map window. A user can zoom to a scale by 
choosing the zoom scale command from the menu bar and entering a scale, such as 1 : 1000. 
Additionally, a user can zoom in to a place, address, or zip code using the zoom goto command from 

1 0 the menu bar, selecting one of these three categories, and entering the name of the location to be 
zoomed to. Moreover, a user can zoom to selected map objects, can go back to a previous zoom 
level, or zoom so that the entire map picture is displayed in the window. A map object can be 
selected by being pointed to with a mouse and single clicking the mouse button. Block 616 
represents the map viewer 118 generating a new map picture based on the zoom command. 

15 [0084] The ellipses in FIG. 6 indicate that other events can be received by the map viewer 118. 

For example, the user may enter a request to open a map picture by choosing the File Open Location 
menu command from the browser's menu bar to display the Open Location dialog or to enter the 
URL of the map that that is to be opened. Additionally, a user can request to pan the map picture. 
Panning allows a user to adjust a map to show a nearby area. That is, when a portion of a map 

2 0 picture is displayed in a window, a user can reposition the map picture within the window to see 
different portions. 

Conclusion 

[0085] The foregoing description of the preferred embodiment of the invention has been presented 
2 5 for the purposes of illustration and description. It is not intended to be exhaustive or to limit the 
invention to the precise form disclosed. Many modifications and variations are possible in light of 
the above teaching. It is intended that the scope of the invention be limited not by this detailed 
description, but rather by the claims appended hereto. 
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Appendix A 
Map Window File Table 



Map Window Information Stream 



Item 


Type 


Description 


Version 


STR 


"2.0.1" 


MapName 


STR 


Map window name. (48) 


MapScale 


FP32 


Initial Map Display Scale. Initially this value will 
be ignored. 


BakClr 


UI16 


Background color 


ExtType 


UI16 


Map Center Type. 

= 1 ; Lat / Lon values. Always used internally 
except for 

=5; User defined meters. 


MapCenX 


FP64 


Center of Map: X coordinate, Longitude 


MapCenY 


FP64 


Center of Map: Y coordinate, Latitude 


MapWidth 


FP64 


Width of Map: meters 


MapHeight 


FP64 


Height of Map: meters 


PCATN 


STR 


Projection Category Name. (64) 


PNAME 


STR 


Projection Name. (64) 


PROJTNT 


UI16 


Projection Type 

= 1 ; Transverse Mercator 

• * ■ 

101; LatLon 
201; User defined 


PELIPT 


UI16 


Projection ellipsoid type 


PDATUM 


UI16 


Projection datum number (pdatum) 


PLATO 


FP64 


Projection latitude of origin (latO) 


PLAT1 


FP64 


Projection l'st standard parallel (latl) 


PLAT2 


FP64 


Projection 2'nd standard parallel (lat2) 


PLONO 


FP64 


Projection longitude of origin / central meridian 
(lonO) 


PLON1 


FP64 


Projection l'st standard longitude, (lonl) 


PLON2 


FP64 


Projection 2'nd standard longitude. (lon2) 


PSCF 


FP64 


Projection scale factor (kO) 


PAZI 


FP64 


Projection azimuth (azimuth) 


PFE 


FP64 


Projection false easting (false east) 


PFN 


FP64 


Projection false northing (false north) \ 


PUMT 


FP64 


= 1 .0; for 1 meter/meter 

= factor; (units/meter) for user defined 

projections. 


PASSWD 


STR 


Password to protect this map window. Encrypted. 
Added in version "2.0. 1" Encrypted in version 



-22- 







"2.0.2" 


AKEY 


STR 


Access key. Encrypted. Added in version "2.0.2" 
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Appendix B 
Map Layer Storage Tables 



Map Layer Information Stream 



Item 


Type 


Description 


Version 


STR 


"2.0" 


LayerName 


STR 


Map layer name. 


AccessControl 


BOOL 


Access control flag. If enabled, a 
user/password pair should be submitted with 
the map layer request to the map server. 


AKey 


STR 


Access key. Encrypted. Renamed and used in 
version "2.0.1" 


Statik 


BOOL 


Specifies if the map layer is static or dynamic 


Visi 


BOOL 


Specifies if the map layer is potentially visible 


VisType 


UI16 


Visibility Type 
= 0; Always visible 
= 1; Visible by scale 
= 2; Visible by width 


Pick 


BOOL 


Specifies if the map layer is pickable 


Edit 


BOOL 


Specifies if the map layer is editable 


Hide 


BOOL 


Specifies if the map layer should be hidden 
from the legend. 


Priority 


FP64 


Specifies the priority of the map layer (0.0 to 
100.0) 


RealTime 


BOOL 


Specifies if the map layer should update itself 
in realtime 


RTSecs 


UI32 


Specifies update time interval in seconds. 
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Map Layer Attribute Set Information Stream 



Item 


Type 


Description 


Version 


STR 


"2.0" 


VisMin 


FP64 


Minimum scale/width at which map layer 
is visible with attributes 


VisMax 


FP64 


Maximum scale/width at which map layer 
is visible with attributes 


ConstSize 
ThemeType 


BOOL 
UI16 


Specifies if objects are constant sized. 
Type of themes 
= 0; None 

= 1 ; Range of values 

= 2; Individual values 

If themes are defined, then the order of 

the themes can be determined by the 

names of the Map Layer Attribute 

streams. 


ThemeDataSrc 


STR 


Name of the ODBC data source for 
themes 


ThemeTblName 


STR 


Name of the table containing the theme 
value 


ThemeKeyCol 


STR 


Name of the column that contains the 
map object key 


ThemeKeyColType 


UI16 


Data type of the key column. Standard 

Core ODBC data types from SQL.H 

= SQL CHAR(l) 

= SQLJSTUMERIC (2) 

= SQL DECIMAL (3) 

= SQL INTEGER (4) 

= SQL SMALLINT (5) 

= SQL FLOAT (6) 

= SQL REAL (7) 

= SQL DOUBLE (8) 

= SQL DATE (9) 

= SQL TIME (10) 

= SQLJTIMESTAMP (11) 

= SQL VARCHAR(12) 


ThemeCol 


STR 


Name of the column that contains the 
theme value 



-25 - 



i nemecol 1 ype 


T TT1 A 
UllO 


Data type oi the tneme column, standard 






UUdL data types trom ayL.ri and 






Date/ 1 ime/ 1 lmestamp 






— oyL_L,rlAK {[) 






— oC^L_N UMbKiC (z) 












oat TMTirPrD fA\ 

— L>yL_JJN 1 xiLrcK (4 ) 






C/^T OA/TAT T TXTT" /C\ 












= SQL REAL (7) 






= SQL_DOUBLE (8) 






= SQL_DATE (9) 






= SQL_TIME(10) 






= SQL TIMESTAMP(ll) 






= SQL VARCHAR(12) 
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Marker Map Layer Attribute Stream 



Item 


Type 


Description 


Version 


STR 


"2.01" 


SymbolName 


STR 


Specifies the name of the symbol: 
FileName.smb\tSymbolName 


SymbolSize 


FP32 


Specifies the size of the symbol 


UseSymbolAttrs 


BOOL 


Specifies whether or not to use the attributes in 
the symbol definition 


TextColor 


UI16 


Specifies the override text color index 


LineColor 


UI16 


Specifies the override line color index 


EdgeColor 


UI16 


Specifies the override edge color index 


FillColor 


UI16 


Specifies the override fill color index 


ThemVall 


STR 


For ThemeType = Range of Values: Minimum 
value 

For ThemeType = Individual Values: The 
value 


ThemVal2 


STR 


For ThemeType = Range of Values: Maximum 
value 


ThemeLabel 


STR 


Label to display in the legend when themed. 
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Text Map Layer Attribute Stream 



Item 


Type 


Description 


Version 


STR 


"2.0" 


TypeFace 


STR 


Specifies the font typeface name 


Weight 


UI16 


Specifies the font weight 


Italic 


BOOL 


Specifies whether or not the font is italicized. 


Height 


FP32 


Specifies the character height 


TextColor 


UI16 


Specifies the text color index 


BkMode 


UI16 


Specifies the text background mode (opaque, 
transparent) j 


BkColor 


UI16 


Specifies the text background color index 


HorzAlign 


UI16 


Specifies the horizontal text alignment 


VertAlign 


UI16 


Specifies the vertical text alignment 


ThemVall 


STR 


For ThemeType = Range of Values: Minimum 
value 

For ThemeType = Individual Values: The 
value 


ThemVal2 


STR 


For ThemeType = Range of Values: Maximum 
value 
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Polyline Map Layer Attribute Stream 



Item 


Type 


Description 


Version 


STR 


"2.01" 


LineStyle 


UI16 


Specifies the line style index 


LineColor 


UI16 


Specifies the line color index 


LineThickness 


UI16 


Specifies the line thickness in thousandths of 
inches 


ThemVall 


STR 


For ThemeType = Range of Values: 
Minimum value 

For ThemeType = Individual Values: The 
value 


ThemVal2 


STR 


For ThemeType = Range of Values: 
Maximum value | 


ThemeLabel 


STR 


Label to display in the legend when themed. 
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Polygon Map Layer Attribute Stream 



Item 


Type 


Description 


Version 


STR 


"2.01" 


FillStyle 


UI16 


Specifies the fill style index 


FillColor 


UI16 


Specifies the foreground fill color index 


FillPattern 


UI16 


Specifies the fill pattern index (hatch/bitmap 
fills) 


BkMode 


UI16 


Specifies the background fill mode 
(hatch/bitmap fills) 


BkColor 


UI16 


Specifies the background color index 
(hatch/bitmap) fills 


EdgesVisible 


BOOL 


Specifies whether or not the polygon edges 
are visible 


EdgeStyle 


UI16 


Specifies the polygon edge style index 


EdgeColor 


UI16 


Specifies the polygon edge color index 


EdgeThickness 


UI16 


Specifies the edge thickness in thousandths 
of inches 


ThemVall 


STR 


For ThemeType = Range of Values: 
Minimum value 

For ThemeType = Individual Values: The 
value 


ThemVal2 


STR 


For ThemeType = Range of Values: 
Maximum value 


ThemeLabel 


STR 


Label to display in the legend when themed. 
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Polyline Label Attribute Stream 



Item 


Type 


Description 


Version 


STR 


"2.0" 


TypeFace 


STR 


Specifies the font typeface name 


Weight 


UI16 


Specifies the font weight 


Italic 


BOOL 


Specifies whether or not the font is 
italicized. 


Height 


FP32 


Specifies the character height 


TextColor 


UI16 


Specifies the text color index 


BkMode 


UI16 


Specifies the text background mode (opaque, 
transparent) 


BkColor 


UI16 


Specifies the text background color index 


ConstSize 


BOOL 


Specifies whether the labels are constant 
size. 


PostingPos 


UI16 


Specifies how the labels should be 
positioned with respect to the polyline 
object. The allowable posting positions are 
as follows: 

0 - post the label above the polyline. 

1 - post the label on the polyline. 

2 - post the label below the polyline. 


MinLength 


FP32 


Specifies the minimum polyline length (in 
meters); polylines shorter than the minimum 
are not labeled. 
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Polygon Label Attribute Stream 



Item 


Type 


Description 


Version 


STR 


"2.0" 


TypeFace 


STR 


Specifies the font typeface name 


Weight 


UI16 


Specifies the font weight 


Italic 


BOOL 


Specifies whether or not the font is 
italicized. 


Height 


FP32 


Specifies the character height 


TextColor 


UI16 


Specifies the text color index 


BkMode 


UI16 


Specifies the text background mode (opaque, 
transparent) 


BkColor 


UI16 


Specifies the text background color index 


ConstSize 


BOOL 


Specifies whether the labels are constant 
size. 
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Marker Label Attribute Stream 



1 i~f*fr\ 

iiem 


Type 


Descnption 


Version 


STR 


"2.0" 


TypeFace 


STR 


Specifies the font typeface name 


Weight 


UH6 


Specifies the font weight 


Italic 


BOOL 


Specifies whether or not the font is 
italicized. 


Height 


FP32 


Specifies the character height 


TextColor 


UH6 


Specifies the text color index 


BkMode 


UH6 


Specifies the text background mode (opaque, 
transparent) 


BkColor 


UH6 


Specifies the text background color index 


ConstSize 


BOOL 


Specifies whether the labels are constant 
size. 


PostingPos 


UH6 


Specifies the preferred position of labels 
with respect to the extent of the marker 
object. There are 8 possible positions 
moving counter-clockwise around the 
perimeter of the extent, with the lower left- 
hand corner being at position 0. 
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Map Object Definition Stream 



Item 


Type 


Description 


Version 


string 


"2.0" 


ObjectType 


UI16 


Type of Object. Enumerated values 
= 1; Marker 
= 2; Text 
= 3; Polyline 
= 4; Polygon 

= 10; Drawing Map Object 


ObjectFrom 


UI16 


Source of the data for object. Enumerated 

values. 

= 0; None 

= 1;SQL 

= 2; SDF 


LocalSource 


BOOL 


Specifies if the data source is local. 


DataSource 


STR 


Name of data source 


ObjectTable 


STR 


Name table 


NameColumn 


STR 


Column from object table for object name 


KeyColumn 


STR 


Column from object table for object key 


LinkColumn 


STR 


Column from the object table for object 
URL link 


LatColumn 


STR 


Column from the object table for object 
latitude 


LonColumn 


STR 


Column from the object table for object 
longitude 


KeyColumnType 


UI16 


ODBC Data type of Key column. Standard 

ODBC data types from SQL.H 

= SQL_CHAR (1) 

= SQLJSfUMERIC (2) 

= SQL DECIMAL (3) 

= SQLJNTEGER (4) 

= SQL SMALLINT (5) 

= SQL FLOAT (6) 

= SQL REAL (7) 

= SQLJDOUBLE (8) 

= SQL_VARCHAR(12) 


HeightColumn 


STR 


Column or expression from the object table 
for text object height in meters 


AngleColumn 


STR 


Column or expression from the object table 
for text object angle in degrees 


ObjectSdf 


STR 


Name of the spatial data file. 


ObjectLinkSql 


BOOL 


Specifies if the spatial data file is linked to 
an SQL data source. If the SDF is linked to 
an SQL data source, DataSource, 
ObjectTable, KeyColumn, and 



-34- 







KeyColumnType must be defined. 


Wnere 




A Where clause if the map layer is based on 
an SQLor SDF map object. The 'Where' 
keyword is not included in the clause. All 
column names should be qualified with the 
name table prefixed to each column name. 


ServerUrl 


STR 


The map server URL for this map layer. 


Projection parameters if we support map objects defined in coordinates other 

then lat/lon 



-35- 



Appendix C 



Report Definition Stream Table 



Item 


Type 


Description 


Version 


STR 


"2.0" 


RptName 


STR 


Name of the report. (48) 


RptUrl 


STR 


The URL used to invoke the report. (128) 


RptData 


STR 


Anv data that is nosted tn the renort TFRT 

(128) 


RptType 


UI16 


Type of report. 

= 0; Send keys of selected map objects. 

= li Digitize a noint and send noint ! 


MapLayerNumber 


UI16 


The number of map layer that this report 
can base on at the same time 

V»*i.l \Jl+Lt\* V/H C± L 111 V JUlliv till IV ■ 

This will be 0 if this report is always 
available. (RptType =1) 
This will be at least 1 if this report is only 
available when obiects are selected from 
this map layer (RptType =0). 


MapLayerName 


STR 


If MapLaverNumber is greater than 0 the 
name of all the map layers will follow. 
If MapLayerNumber is equal to 0, this item 
will be omitted. 


• 
• 

■ 

• 






MapLayerKeyName 


STR 


If MapLayerNumber is greater than 0, the 
name of all the map layer keys will follow. 
If MapLayerNumber is equal to 0, this item 
will be omitted. 


% 

m 
■ 


• 
« 

• 

• 




Prompt 


STR 


Prompt string requesting user to select a 
point (RptType=l). 
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Appendix D 



Zoom Goto Storage Table 

5 Zoom Goto Address Stream 



Item 


Type 


Description 


Version 


STR 


"2.0" 


Type 


UI16 


= 1 ; US Street Address 


ServerUrl 


STR 


The URL of the Map Server to direct this 
request to. 


AKey 


STR 


Access key. Encrypted. Added in version 
"2.0.1" 



Zoom Goto Location Stream 



Item 


Type 


Description 


Version 


STR 


"2.0" 


Type 


UI16 


= 1; Location in SQL Datasource 
= 2; Location in SDF file. 


ServerUrl 


STR 


The URL of the Map Server to direct this request 
to. 


Category 


STR 


A name that describes the category for this zoom 
goto location definition. These string is listed in 
a dropdown combo box in the Zoom Goto 
Location Dialog 


MaxReturn 


UI16 


The maximum number of location matches to 
return. The Map Server may override this value. 


SQL 


STR 


The SQL Select statement that the map server 
should execute. 

The Name of the SDF that the server should 
search. 


DataSource 


STR 


The data source that the SQL select statement 
should be run against. 


AKey 


STR 


Access key. Encrypted. Added in version 
"2.0.1" 
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Appendix E 



Popup Menu Stream Table 


Item 


Type 


Description 


Version 


STR 


"2.0" 


Numltems 


UI16 


Number of menu item definitions to follow. 


Menuitem # 1 




See table below. 


• ■ t 






Menuitem # N 




See table below. 


Menu Item Definition 


Item 


Type 


Description 


Name 


STR 


Name of item to appear in the menu. 


Type 


UI16 


Type of item. Enumerated values: 
= 0; Menu item 
= 1; Separator 
= 2; Begin menu 
= 3; End menu 


Actionld 


UI16 


The action to be performed when the menu item 

is selected. 

= ACTION_PAN 

■ » • 

= ACTION_GETPOINTSEND(<URL>) 

ACTION SENDSELOBJKEYS(<URL>,<LAY 
ER>) 

= ACTION REBUILDLAYER(<LAYER>) 
= ACTION_OPENMAP(<URL>) 
= ACTION_URL(<URL>) 


ActionArgs 


STR 


Arguments that may be required for some of the 
actions. String arguments should be enclosed in 
double quotes. Multiple arguments should be 
separated by commas. 
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Appendix F 
URL Tables 

FormatURL [?Options][# Anchor] 



Option Parameters 



Parameter 


Description 


Old.lUb.DaI 


opcLiiies u didiuo Dai is uispiaycu. | wiij 


Layers ViewWidth 


Specifies the width of the map layer legend in 
pixels. Default: 150 


DefaultTarget* 


Specifies the name of the target window where 
the map viewer will display HTML documents 
and display URLs referenced in the OpenUrl, and 
OpenMap actions. These actions can be defined 
when customizing the popup menu in map author. 


Obj ectLinkTarget * 


Specifies the name of the target window where 
the map viewer will display the URL associated 
with a map object. 


ReportTarget* 


Specifies the name of the target window where 
the map viewer will display reports returned from 
View Report command. 


ErrorTarget* 


Specifies the name of the target window where 
the map viewer will display the URL. 


UrlList 


Specifies if the map viewer should generate an 
HTML document that lists the names and links of 
map objects that have URLs associated with them 
when map objects are chosen in the map viewer. 
The HTML document is displayed in the 
UrlListTarget window. [On | Off] 


UrlListTarget* 


Specifies the name of the target window where 
the map viewer will display its UrlList when map 
objects are chosen. 


AutoLinkLayers 


Specifies if the plug-in should automatically 
download and display the URL associated with 
map objects from the named map layers. The 
URLs are displayed in the AutoLinkTarget 
window. 


AutoLinkTarget* 


Specifies the name of the target window where 
the map viewer will display the URLs 
downloaded from the AutoLinkLayers. 


AutoLinkDelay 


Specifies the number of seconds before the next 
URL associated with a map object from an 
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AutoLinkLayer will be displayed in the 
AutoLinkTarget window. Default value is 20. If 
0 seconds is specified as the delay, the automatic 
timed update feature will be disabled and the 
AutoLinkTarget window will be updated when 
the mouse passes over a map object on an 
AutoLinkLayer. 

*A11 of the target option parameters also accept the following reserved target 
names: 



Target Name 


Description 


_blank 


Loads the link into a new blank browser window. The 
window has no name. 


^parent 


Loads the link into the immediate parent of the document 
that the link is in. 


_self 


Loads the link into the same window that the link was 
clicked from. 


_top 


Loads the link into the full body of the window that the 
link was clicked from. 
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Anchor Parameters 



Parameter 


Description 


Lat 


Latitude of center area to display. Decimal degrees. 


Lon 


Longitude of center of area to display. Decimal degrees. 


Width 


The width of area displayed in the map viewer. 


Units 


Units used to specify width. [MI | KM | M | FT] 



Examples: 

http ://www .mapguide .com/amap .mwf#L AT=- 1 1 0 .0&Lon=4 3 . 1 &Width= 1 00&Units=mi 
http://www.mapguide.com/amap.mwffStata 

aultTarget=MAIN ARE A#LAT=- 1 1 0 .0&Lon=43 . 1 &Width= 1 00&Units=mi 

http://www.mapguide.com/amap.mwf?StatusBar=On&UrlList=On&AutoLinkLayers=Billb 
ds&Layers ViewWidth= 1 &DefaultTarget=M AINAREA&UrlListTarget= WEB SITES& AutoLin 
kTarget=BILLBO ARD& AutoLinkDelay= 1 0#LAT=- 1 1 0 .0&Lon=43 . 1 & Width= 1 00&Units=mi 
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